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FOREWORD 


Programs operating in the Basic Programming System may have been coded directly in the 
Honeywell Easycoder Symbolic Language, or they may have been translated from SPS or Auto- 
coder programs by Easytran 1401 or Easytran Symbolic Translator B. This bulletin considers 
only programs that have been coded directly in Easycoder. Translated programs present other 
problems and for them there is a Honeywell- supplied program, Easytran Program Modifier C, 
that will make the appropriate modifications. Alternatively, the original SPS or Autocoder pro- 
gram may be retranslated with Easytran Symbolic Translator C or D. Appropriate procedures 
will be found in the manuals for these programs — Easytran Program Modifier C Manual , Order 
No. 147; Easytran Symbolic Translator B and C Reference Manual , Order No. 035; or Easytran 
Symbolic Translator D Manual, Order No. 220. 

The reader of this bulletin is assumed to be familiar with the Honeywell Series 200 Pro - 
grammers' Reference Manual, Order No. 139 and the Easycoder B Assembly System Manual, 
Order No. Oil. Other relevant documents include the Easycoder Assemblers C and D Manual, 
Order No. 041; the Tape Loader -Monitor C Manual, Order No. 221; and the Floating Tape Loader - 
Monitor C Manual, Order No. 005. 
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SECTION I 


INTRODUCTION 


GENERAL 

This bulletin will help users of the Series 200/Basic Programming System change over to 
the Mod 1 Operating System to take advantage of more integrated and efficient methods of oper- 
ation. As computer jobs get larger and more complex, it becomes more economical to inte- 
grate and automate operation — processing by jobs rather than by individual programs. This 
greatly reduces idle system time resulting from operator intervention during operation. By 
establishing automatic job control, using a deck of prearranged action directors or an internal 
communication scheme between program units, a job or a series of jobs, each consisting of 
several programs, can be processed automatically without the delays of manual control. The 
operating system increases throughput, makes operation faster, provides for more systematic 
and orderly growth, and permits multiprogramming. 

In Mod 1, control and service programs are provided to perform some of the routine 
supervisory functions that would otherwise be performed by the operator. A user may select 
from the available system software whatever program preparation and maintenance, data tran- 
scription and editing, and utility programs his job requires. Then, using monitor and control 
programs, he processes the job automatically thereby reducing idle system time as well as 
chances for human error. The jobs may be arranged for either stacked job or batched proc- 
essing, depending on which consideration is more important — fast turnaround time, or optimum 
machine utilization. 

In moving from the Basic Programming System to Mod 1, there are significant changes in 
the operating environment. Most differences are resolved automatically by reassembly, but 
there are a few changes that must be made to a program written to be run in the Basic Program- 
ming System before it can be run in the Mod 1 Operating System. 

SYSTEMS DESCRIPTION 
Basic 

The Basic Programming System is card oriented. It is designed to run on a small com- 
puter with 4K to 12K characters of memory, so it must make the best use of limited memory, 
foregoing resident control functions. Programs are individually assembled and independently 
executed. Each program is an independent entity with its oWn facilities for self-loading, data 
manipulation and specialization, and diagnostic analysis. Jobs are scheduled and executed on a 
demand basis. If tapes are used, they are self-loading — still unit-record oriented. 
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Mod 1 


The Mod 1 Operating System is tape oriented and designed for systems with 1 2K to 65K 
characters of memory, three to six tape units, and perhaps a mass storage file. Programs can 
be operated individually as in the Basic Programming System, or in continuous semi -centralized 
jobs. The programs that make up the jobs, although for the most part independently generated, 
are joined and coordinated in the operating system. 

The Mod 1 System comprises a group of related programs which handle language proc- 
essing, file maintenance, loading, interrupt processing, input/output operations, and program 
testing. The language processing and file maintenance programs are used to create executable 
files and store and maintain them on binary run tapes (BRT). Programs may be called from 
these executable files in any sequence as they are needed in processing a job. In addition to the 
executable files, the Mod 1 System also maintains files of source programs and library routines, 
in both symbolic and machine -language form, on symbolic program tapes (SPT). Executable 
BRT files may be created from these SPT's, without each time going through the assembly 
process. To update the SPT's, only the corrections need be supplied for assembly — it is not 
necessary to resubmit the entire source program deck as it is in Basic. 

The loader -monitor is the only program permanently in memory during a run, and as such 
it has a central function in the system. The communication area of the loader -monitor is used 
to control the sequencing of successive programs in a job. Using this communication area, a 
user can load and execute programs in any order he desires. Operation directors, which may 
be in the form of cards, operator entries, or programmed instructions, are used to control the 
loader -monitor and other systems programs. These directors designate which programs will 
be read into memory and executed and provide the parameters these programs need. 

Pre-execution specialized input/output routines provide standardized and coordinated pe- 
ripheral operation. They read and write files, block and unblock records, label files, and check 
for errors. 

A subsystem of coordinated program test routines facilitates the checkout of programs by 
providing diagnostic information before, during, and after execution. Each of the constituent 
routines can be used separately or as an integrated part of the subsystem. The subsystem can 
process either individual programs or a job, automatically producing the documentation necessary 
to evaluate the programs. 

Table 1-1 provides a comparison of representative programs and routines of both systems. 


Table 1-1. Compari 


Basic 


Language Processing 

Easycoder Assemblers A and B 
Easycoder Assembler A(P) 
Library Processor B 
COBOL Compiler B 


Program Editing and Maintenance 

Condense A 
Update A 


Operation Control 

Card Loader-Monitor B 
Tape Loader /Search A 


Input /Output Control 

Tape I/O Translator A 

1/2" Tape I/O A 

1/2" Tape I/O B 

1/2" Tape and Terminal I/O B 

Console I/O B 

Program Test 

Memory Dump A 

Tape Handling Routines A and B 


of Systems Programs 


Mod 1 


Language Processing 

Easycoder Assemblers C and D 
COBOL Compilers D and H 
Fortran Compiler D 
Library Processors C and D 
Analyzer C 

Program Editing and Maintenance 

Update and Select C and D 
SPT Merge C 
BRT Punch C 
Drum Program Store C 

Operation Control 

Card Loader -Monitor B 
Drum Bootstrap-Loader C 
Drum Monitor C 
Tape Loader-Monitor C 
Floating Tape Loader-Monitor C 
Interrupt Control D 

Input /Output Control 

Standard I/O Calls C 

1/2" Tape I/O C 

1/2" Tape and Terminal I/O C 

Drum I/O C 

Console I/O C 

Program Test 

Program Test System C 
Initializer C 
List Comments C 
Test Data Generator C 
Memory Dump Control C 
Memory Dump C 
Octal Correction C 
Tape Dump C 
Emergency Dump C 
End C 












SECTION II 
PROCEDURES 


GENERAL 

Transition from Basic to Mod 1 must be made at the source language level. All programs 
must be reassembled with Easycoder Assembler C (or D). If the usual good programming con- 
ventions had been observed in writing the original programs, so that they can easily be relocated, 
most of the differences between the two operating environments are resolved simply by reassem- 
bly. Only a few changes in some of the assembly control statements need to be made in the 
source program. 

Mod 1 uses a resident loader -monitor and the most important considerations in the transi- 
tion concern the location and use of that monitor. Programs obviously may not use memory lo- 
cations reserved for the monitor, which means that many programs will have to be relocated. 

The memory areas reserved for the various loaders are shown in Figures 2-1 and 2-2. 



Figure 2-1. Memory Maps Showing Basic Loaders 


In Mod 1, memory locations 64jg through 189io are reserved as a communication area for 
the loader -monitor, and any program that uses these locations must be relocated. 

Programs that do not use locations below 190 jq can be operated under the control of Float- 
ing Tape Loader -Monitor C without relocation, provided that sufficient space is left in upper 
memory for the loader -monitor (1,400 to 2,750 locations, depending on the configuration). 

This includes any programs that are presently loaded from a self-loading tape (SLT), which do 
not overlay Tape Loader/Search A during execution. The Floating .Tape Loader -Monitor can be 
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assembled to reside in any portion of memory above 8K and can be relocated at execution time 
to the end of any 4K module except banks 0 and 1. 


If, instead of Floating Tape Loader -Monitor C, one of the other loade r -monitor s is used, 
programs will have to be relocated higher. For Card Loader-Monitor B, to 1, OOOjq or above; 
for Tape Loader -Monitor C or Drum Monitor C, to 1340jq or above. 



1400 TO 2700 LOCATIONS 


LAST CHARACTER OF SOME 
4K MEMORY BANK ABOVE BK 


LOADER-MONITOR 
COMMUNICATION AREA 


1000,0 


1340 , 


Figure 2-2. Memory Maps Showing Mod 1 Loaders 


RELOCATION 

When a program is relocated, references to absolute addresses must of course change. 
This is no problem if symbolic addressing has been used throughout the source coding — re- 
assembly will make the required adjustments. But absolute addresses must be individually 
changed. You should check the following areas of the coding for any absolute addressing: 

1. Location fields 

2. ORG and LITORG statements 

3. DSA and EQU statements 

4. CLEAR, EX, and END statements 

5. Instruction Address fields 

6. Programming techniques that assume fixed locations 

To avoid the expense and trouble of hand tailoring when relocating a program, you should 
in your coding consistently observe the following conventions: 
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1 . 


Use absolute addressing only in the first ORG Statement and when referring 
to permanently reserved areas like the index registers and the loader- 
monitor communication area. (Even here, it is a good idea to write EQU's 
and use symbolic tags. ) 

2. Do all other addressing with (or relative to) symbolic tags. 

3. Avoid programming techniques that assume fixed locations or a particular 
address mode. 

You need, then, only change one ORG statement (and possibly some ADMODE statements) to re- 
locate the entire program. Modifying programs to conform to these conventions, if this has not 
been done in the past, will make them easily relocatable at any time in the future. 

Address Mode 

If a program that normally uses two-character addressing is relocated into a higher mem- 
ory bank, it usually should be reassembled to use three -character addressing. A program may 
use two-character addressing only if it is kept entirely within one 4K memory bank. 

When the address mode of a program is changed, any programming practices that assume 
two-character addressing must also change. For instance, since instruction operand lengths in- 
crease, any absolute relative addressing on instructions must be modified. Also, since the longer 
instructions require more memory, you may have to change some ORG or LITORG statements. 

The Mod 1 Loaders all operate in three-character mode. If it is desired to still run the 
program in two-character mode, you must insert CAM instructions (and ADMODE statements) 
wherever control is transferred between the program and the loader. And when you CAM from 
three- to two-character mode, you must be sure that the bank bits in the A- and B-address reg- 
isters are set to the proper bank. So in each segment of a two-character program, the first 
instruction (or if there is an initial SCR, the next instruction after it) must set the bank bits of 
the A- and B-address registers and be followed by a CAM to two-character mode. And the last 
instruction before the branch to the loader must be a CAM to three-character mode. 


EASYCODER 

CODING FORM 

PROBLEM PROGRAMMER DATE PAGE OF 



i 

i 

LOCATION 

OPERATION 

CODE 

OPERANDS 


no 

non 

□ 

□ 

8 l . . .14 

15, . . .20 

i .... i .... i ... . - 6Z 

63, , , . , i . , . .80 


r 

. i 


r 


mm 


mmHmnmi 

ITT 



STA.RTX 

SCR 

CXI T, 70 



i 




3M 

* T. , . .SET UP. A.arxfB REGISTER, SANK E 

ITS, . 


i 




333 

20 . ............. ..... 


MM 







i i 







i ! 



, 

; $ 







Admo.d.e 



i i 




CAK 



:i'l 



EX,I T 




. . 1 . . . . 1 . i . . 1 . . . . 

i t 
*i.i 

_ 


. 1 . 

X 

UJ 

START, X. . . . ■ .... ■ ......... i .. . 

1 1 1 . . 1 1 > 1 i ■ 1 1 ■ 1 ■ 


2-3 

















Program Header - PROG 

Punch a new PROG card in the Assembler C format. In Mod 1, the PROG card is used as 
a system action director as well as a program header. It requires additional information and is 
coded slightly differently (see the Easycoder Assemblers C and D Manual, Order No. 041). For 
the example shown in Figure 2-4, both PROG cards name the program to be assembled and ask 
for a sequence check of the source deck and an assembly listing. 


BASIC 


/ 

' i a ** • 

8 

s 

7 8 8 » It fit t» 14 

IS 14 17 M 

PROG 

!» 20 

2122 29 24 29 20 

(Program 

Name) 

27 28 28*091 R 9* 949498 92 M 9*4041 42 4844 49484748 4t 00 » 32 9* 94S9 M 87 M M SO* 82 SS 848588 8788 M TO 71 72 79 747*78 7? 7* »8 SO 


MODI 

/ 

1 2 9 

INS 

4 9 4 r • « O It It II 14 

19 W 17 IS 

PROG 

it M 

!l 2223 24 29 28 

(Program 

Name) 

tT 2* 28 *0 St *2 *9 84 94 *8 57 81 ** 4©4« 42 4*44 48 444748 48 SO S 92 « 94 85 98 S7SS 98 *0 St 8* S9 84 SSSt) S7SS SS K 

71 

S 

n nr* n r* rt nn so 


Figure 2-4. PROG Cards for Basic and Mod 1 


Table 2-1. PROG Card Format for Assembler C 


Columns 

Contents 

Explanation 

1 - 3 

Action Directive Code 

See the Assembler C Manual for the 
functions of each action director. 


COR - Correct 
INS - Insert 
LST - List 
SEL - Select 
CPY - Copy 
DEL - Delete 
POS - Position 
END - End 


8-10 

Program Revision Number 

If this field is blank, assembly will 
assign a revision number to the pro- 


Three- character field 

gram. If the field contains a number, 


that is blank or contains 

that number will be used as the re- 


a number from 001 to 

vision number. Revision numbers 


999 10 . 

are assigned in the order of updating, 
beginning with 001. 

15 - 18 

PROG 

Specifies card as Program Header. 
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Table 2-1 (cont). PROG Card Format for Assembler C 


Columns 

Contents 

Explanation 

21 - 26 

Program Name 1 

Six-character program name. 

28 - 33 

Program Name 2 

Six-character program name used 
with all action directors except DEL 
and END. 

35 - 70 

Visibilities 

Used with all action directors except 
DEL and END. May contain blanks, 
*, or visibility codes from A-Z, 0-9 
in any order. 

71 - 80 

Options 


71 

S 

Sequence check. 

72 

G 

Generate line numbers. Can be used 
with INS, COR or CPY action direc- 
tors. 


H 

Check hash total. This field will be 
used as an aid to field maintenance. 

73 

X 

Do not list program. Can be used 
with CPY, COR, or INS action 
directors. 

74 

L 

List program. Can be used with 
SEL action director only. 


X 

Do not write machine language on the 
BRT or on punched cards. Can be 
used with CPY, COR or INS action 
directors. 


c 

Write machine language on punched 
cards instead of on the BRT. Can 
be used with CPY, COR, INS, or 
SEL action directors. 

75 - 80 

Not used 



Segment Header - SEG 

It is not necessary to insert SEG statements — Assembler C will automatically define seg- 
ments by assigning ascending numeric designations starting with 01. But if you insert any seg- 
ment headers, then there must be one for every segment. 
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Set Address Mode — ADMODE 


Include an ADMODE statement at the beginning of the program. If the program occupies 
more than one 4K memory bank (programs that didn't before may now after being relocated), 
three -character addressing must be used. Remember that when there is no ADMODE statement, 
Assemblers A and B assume two-character addressing while Assembler C assumes three-charac- 
ter addressing. 

Clear — CLEAR 

Move any CLEAR cards in the symbolic program to the front of the deck, right behind the 
ADMODE card (see Figure 2-1). In Assemblers A and B, all CLEAR cards were placed at the 
end of the symbolic program and repositioned by assembly to the beginning of the program to be 
executed before loading. But this is not the case with Assembler C. Here a CLEAR statement 
is executed during loading at exactly the position it appears in the symbolic deck. 

Origin - ORG 

When using Floating Tape Loader -Monitor C, you must ORG all programs to location 190jq 
or above; Card Loader -Monitor B, to I.OOOjq or above; Tape Loader-Monitor C or Drum Moni- 
tor C, to 1,340 jo or above. All ORG statements after the first should use relative addressing so 
that the program can be relocated by changing only one ORG. 

Check the location field of all ORG statements to be sure that there are no indented tags. 
Assemblers A and B treat indented tags in the location field of an ORG statement the same as 
left -justified tags, and assign them to the address specified in the operands field. Assembler C, 
however, assigns such tags to the location at which the next instruction would have begun if the 
ORG statement had not been present. 

Literal Origin - LITORG 

If any executable instructions follow a LITORG statement, you must insert an ORG back to 
the location following the instruction that preceded the LITORG. This is necessary because As- 
sembler C assigns instructions that follow the LITORG differently than Assembler B. Assembler 
B assigns these instructions the same as if the LITORG had not been present. But Assembler C 
assigns subsequent instructions to locations following the literal table. So with Assembler C it 
is necessary to ORG back to the proper location. To do this, write an indented tag in the loca- 
tion field of the LITORG statement; then, immediately following the LITORG, insert an ORG to 
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0,R6 
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- 44 - 
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— ---I J i i i 
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Control Equals - CEQU 

Check all CEQU statements to see if any contain more than 4 characters (8 octal digits). 
Divide each CEQU statement that contains more than 4 characters into two CEQU statements. 
Then throughout the program, change each instruction that references the original CEQU so 
it refers also to the second CEQU. This is necessary because, although Assemblers A and B 
can handle 6 character (12 octal digit) CEQU's, Assembler C can handle only CEQU's of up to 
4 characters (8 octal digits). 
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PROBLEM PROGRAMMER DATE PAGE OF 
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NUMBER 

£ 

¥ 

3 
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OPERATION 

CODE 

OPERANDS 
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5, 20 
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Memory Dump - HSM 

Remove all HSM statements. They are not used in Mod 1 and are treated as illegal state- 
ments. You may use, instead, a call to any of the more powerful and flexible program test rou- 
tines that are available for Mod 1. Refer to the Program Test System C Manual, Order No. 049. 
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Execute - EX 


Check to be sure that the operands field contains a starting address. This may be left 
blank (to load and halt) in Basic, but not in Mod 1. To load and halt in Mod 1, you must enter 
the program and segment name into the Halt Name parameter (locations 77 through 84) of the 
loader-monitor communication area. 

The coding preceding an EX statement must of course provide a return to the loader. A 
method of returning to the loader that is compatible with both programming systems (the Special 
Call) is to incorporate, as the first instruction of the segment to be executed, an SCR instruction 
that moves the contents of the B-address register into the A-address field of a return Branch in- 
struction at the end of the segment. This sets up a branch back to the instruction in the loader that 
follows the loader's starting branch to the segment. The loaders in both programming systems 
interpret this as a call for the next segment. (If the program is to run in 2-character mode, 
see page 2-3. ) 
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However, in Basic the return to the loader may have been a branch to a read routine in the 
bootstrap area or, with an SLT, to location 1 1 1 1 o °f Tape Loader /Search A. For Mod 1, you must 
change this to a special program call (above) or to a normal program call, which, after entering 
the name of the next segment into locations 74^ and 75 jq of the loader-monitor communication 
area, branches to location 130jq. 
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End - END 

Check to be sure that the operands field contains a starting address. This may be left 
blank (to load and halt) in Basic, but not in Mod 1. To load and halt in Mod 1, you must enter the 
program and segment name into the halt name locations ( 7 7 ^ q through 84 jq) of the loader-monitor 
communication area. 

As with the EX statement, the coding preceding an END statement should provide a return 
to the loader-monitor. In Basic, the last executable instruction of the program may have been a 
halt. To obtain the equivalent in Mod 1, you should replace the halt with an indirect branch to 
location 139io of the loader -monitor communication area, which causes a console call halt. (If 
the program is to run in 2-character mode, see page 2-3.) 
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The Basic program, if loaded from an SLT, may have used a normal program call — 
moving the name of the next program into loader locations 101 jq through 106jq and branching to 
location 86 jg* To obtain the equivalent in Mod 1, you should move the program and segment 
names of the next program into locations 6 8 ^ q through 73jq and 74jq and 75jq of the loader-moni- 
tor communication area, and then branch to location 130jq. 
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The Basic program may have called for the next program on the tape by simply branching 
to location llljg* The only way this can be done in Mod 1 is to use the special program call that 
was described for the EX statement. This method can be used only if the programs are arranged 
on the tape in exactly the order they will always be run. 


An entry in the location field of the END statement, which in Basic specifies the bootstrap 
area, has no significance in Mod 1. 
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MACHINE INSTRUCTIONS 


The only machine instructions that could present any problems for reassembly by Assembler 
C are (1) those containing area-defining literals, and (2) those with both an absolute decimal ad- 
dress in the location field and an asterisk (*) in the operands field. 

In Basic, after any LITORG or EX statement, the tag of any area-defining literal must be 
redefined. But Easycoder Assembler C keeps the original assignment throughout the program, 
and redefining the tag will cause a duplicate symbol error. So in any instruction that contains a 
redefinition of an area defining literal, you should use a new symbol to define a different area. 

In any instruction with an absolute decimal address in the location field, an asterisk in the 
A- or B-address field should be replaced with the proper decimal value. Otherwise, Assembler 
C, instead of assigning to the asterisk the value in the location field, will assign the location 
following the previous instruction. 
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